home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 1 / QRZ Ham Radio Callsign Database - December 1993.iso / ucsd / packet / misc / ad15dis.exe / README < prev    next >
Encoding:
Text File  |  1991-01-21  |  14.6 KB  |  305 lines
  1.                    README file for ARES/DATA  Version 1.5
  2.  
  3. Welcome to ARES/DATA!  Your diskette contains the following files:
  4.  
  5. README          (This file itself)
  6.  
  7. DOCUMENTATION FILES:
  8.  
  9.         USERMAN.DOC     Packet operator full user manual
  10.         QUIKREF.DOC     Quick Reference Card for the packet operator
  11.         DRSI.DOC        Notes on the DRSI PC*PA packet adapter
  12.         SYSOP.DOC       Summary of SYSOP procedures and commands
  13.                         - READ THIS BEFORE ATTEMPTING TO RUN ARES/DATA
  14.         G8BPQ.DOC       How to use the BPQ switch and KISS TNCs
  15.         CONFIG.DOC      Notes on the config file
  16.         ARESDA01.PAP    Revised text of paper on previous version, 0.1
  17.         ARESDA10.PAP    Revised text of paper on previous version, 1.0
  18.  
  19.         INPUT.HLP
  20.         SEARCH.HLP
  21.         SUMMARY.HLP       These files are short reminders of the A/D
  22.         LIST.HLP          syntax and functions.  Put them in the \PUBLIC
  23.         CHANGE.HLP        subdirectory so that users can download them.
  24.         CONFBRGE.HLP
  25.  
  26. ARESDATA.CFG      An example configuration file
  27. STARTUP.TN1       An example startup file for a WA8DED TNC-1
  28. STARTUP.PCP       An example startup file for a DRSI PC*PA board
  29. STARTUP.P87       An example startup file for an AEA PK-87 w/ DED firmware
  30. STARTUP.TN2       An example startup file for a TNC-2 with DED firmware
  31. INFO              An example INFO file for ARES/Data - put in \public
  32.  
  33. ARESDATA.BAT      The startup batch file for running the program
  34. ARESDA15.EXE      The ARES/DATA program version 1.5
  35.                     Searches available on all 4 index fields
  36.                     Generated for 10,000 record database
  37. AD15-3.EXE        ARES/Data program with searches for fields 1, 2, or 3 only
  38. AD15-2.EXE        ARES/Data program with searches for fields 1, or 2    only
  39. AD15-1.EXE        ARES/Data program with searches for field  1          only
  40.                   (These three versions of the program may not be present on
  41.                    your disk.  If you want them, contact us.)
  42.  
  43. MBBIOS.COM        The MBBIOS memory-resident program for handling serial ports
  44. MBBCONFG.EXE      The configuration program for MBBIOS
  45.  
  46. STARTBPQ.BAT      Startup file for G8BPQ switch code.
  47. BPQCFG.TXT        Configuration file for G8BPQ switch (example).
  48. DEDHOSFE.COM      DEDHOST.COM modified to use software interrupt hex FE.
  49.  
  50. ZAPDB.BAT         A batch file to move the current database files to
  51.                       another set of names and start anew with an empty
  52.                       database
  53.  
  54.                   These files describe commands for TNC's using WA8DED
  55.                         firmware:
  56. TNC1DED.DOC       Documentation for the WA8DED TNC-1 Firmware Version 1.3
  57. TNC2DED.DOC       Documentation for the WA8DED TNC-2 Firmware Version 2.5
  58. PK87DED.DOC       Documentation for the WA8DED AEA PK-87 Firmware
  59.  
  60.  
  61.  
  62.           Introduction and Overview for ARES/Data Version 1.5
  63.  
  64.  
  65.  
  66.                               ARES/Data
  67.  
  68.            A Packet-Radio Database for Emergency Communications
  69.  
  70.  
  71.  
  72. I.  INTRODUCTION
  73.  
  74. ARES/Data is basically a multiple-connect, multiple-port specialized bulletin
  75. board system with a conference bridge that is tailored to store and retrieve
  76. basic information about people, places, or things in an emergency or disaster.
  77. The program is a generalized form of the FINDER program (Family Information
  78. Database for Emergency Responders, by WN6I and N6KL, 1987).  Although ARES/Data
  79. allows access to the database via packet radio, the program can also operate
  80. stand-alone without any packet radio access.  The actual operating mode is
  81. chosen by the system operator when the ARES/Data program is started.
  82.  
  83. ARES/Data is a system designed for management of information during a
  84. widespread emergency that overloads normal communications channels.  The
  85. program is conceived to be flexible, so that it can be used without
  86. change for both small and large disasters to organize information about
  87. victims, evacuees, or even ham radio operators.  Examples of situations
  88. in which ARES/Data could be used are (i) registration of individuals at
  89. Red Cross shelters, (ii) patient/victim tracking in a multiple casualty
  90. incident, (iii) maintaining staffing information about hams assigned to
  91. an emergency, (iv) listings of road closures or damage reports, and so
  92. forth.  With alternate power sources and their own frequencies, Amateur
  93. Radio Operators can provide the ARES/Data service without tying up
  94. critical communications channels or relying on commercial power.
  95.  
  96. References:
  97. FINDER: Proc. of the Sixth ARRL Computer Networking Conf., p.134 (1987).
  98. ARES/Data 0.1: Proc. of the Seventh ARRL Comp. Net. Conf., p.141 (1988).
  99. ARES/Data 1.0: Proc. of the Eighth ARRL Comp. Net. Conf., p. 134 (1989).
  100. Public Service Column in QST, December, 1990, p. 75.
  101.  
  102. II. ARES/Data SYSTEM OVERVIEW
  103.  
  104. A.  Three Major Elements
  105.  
  106. There are three major elements to the ARES/Data system:
  107.  
  108.   o ARES/Data software and database (at one centrally located computer)
  109.   o Remote packet stations connected to the central node
  110.   o Conference Bridge
  111.  
  112. The central element of the ARES/Data system is the ARES/Data database
  113. program running on an IBM PC or compatible.  The ARES/Data program
  114. collects and collates current information about people (or other items)
  115. according to the needs of the incident.  The sysop at this computer can
  116. execute all database functions if necessary; it is not required that a
  117. TNC be connected to the computer.
  118.  
  119. If remote access is desired to the information in the database, this
  120. computer may be connected to a packet radio channel through up to four
  121. ports, each of which can be either a TNC with WA8DED firmware or a DRSI
  122. PC*PA packet radio adapter.  In this manner, other remote packet
  123. stations can connect to the ARES/Data machine and thus gain access to
  124. the stored information.  This information can be updated or queried by
  125. the sysop or any of the remote packet stations that are all
  126. simultaneously connected to the main database station.  The data access
  127. occurs by exchanging updates or queries in a simple, precise, and
  128. well-defined format.  A remote packet operator can both enter data into
  129. the system and execute searches for specific pieces of information.
  130.  
  131. During all of this, all of the connected stations and the sysop can
  132. communicate with each other by using a simple "tell" command.  This
  133. "conference bridge" actually implements a star-shaped network in which
  134. the central database station relays all of the message traffic.
  135.  
  136. III.  ACKNOWLEDGEMENTS
  137.  
  138. Since the ARES/Data concept is a generalization of the FINDER system,
  139. the deliberations of the FINDER committee in the Santa Clara Valley
  140. Section of the ARRL have contributed to the present form of ARES/Data.
  141. In addition, our thanks also go to all the ham radio operators in the
  142. Santa Clara Valley Section that have participated in the various alpha
  143. and beta tests of the FINDER and ARES/Data systems.  We also greatly
  144. appreciate the comments and suggestions we have received from hams all
  145. over the world who are using ARES/Data.
  146.  
  147. IV. Version 1.1 Differences
  148.  
  149. Everything you may already know about ARES/Data Version 1.0 still
  150. holds true for Version 1.1.   Version 1.1 fixes some minor bugs, and
  151. provides three new features:
  152.  
  153. 1. STATUS command:  Provides a brief system status, i.e., the current
  154.   LABELS settings, current WIDTHS settings (see below), and the current
  155.   database size.
  156.  
  157. 2. Origin Indicator:
  158.   (Thanks to Pierre Cornelis, ON7PC for this very good idea):
  159.   At the beginning of the MESSAGE field, there will now always be an
  160.   indication of which station last updated each record.  The station
  161.   callsign (or the word "SYSOP") will appear here, so that in case of
  162.   data entry errors, or other questions, everyone can know who made
  163.   which entry.  An example record:
  164.  
  165.   Date/Time LName   FName Call  Phone     Message
  166.   27/1234:  PALMER, DAVE, N6KL, 555-1299, <W6XYZ> DAVE CAN LOAN A RADIO
  167.  
  168.   The origin indicator is fully automatic.
  169.  
  170. 3. WIDTHS command.
  171.  
  172.   The Widths command allows you to more neatly format output data
  173.   on the screen.  It doesn't change the data in any way, but provides
  174.   a way for the column output to "look right".  If the value for any
  175.   field is shorter than the defined WIDTH for that field, then when
  176.   that record is displayed, spaces will be used to try and keep the
  177.   fields aligned on the display.  If a given value is longer than the
  178.   specified WIDTH, then all of the value is displayed, and the
  179.   following fields will likely not be aligned neatly.   (But for most
  180.   records they would be).   Set the WIDTHS anytime you wish; typically
  181.   when you change the meanings of the data base fields when you use the
  182.   LABELS command.  The syntax for the WIDTHS command is very similar to
  183.   that for the LABELS command:
  184.  
  185.   Find out the current WIDTHS:
  186.       widths
  187.  
  188.   Set the widths, so that Field1 has 10 characters, Field2 has 6,
  189.   Field3 has 8, and Field4 has 10:
  190.       widths=10,6,8,10
  191.  
  192.   If you set the widths this way, then output might now look like this:
  193.  
  194. Recno  DT/Time   LName      FName  Call     Phone      Message
  195.    1   27/1234:  PALMER,    DAVE,  N6KL,    555-1299,  <W6XYZ> DAVE ENROUTE
  196.    2   27/0001:  MAXIM,     HIRAM, W1AW,    555-1551,  <SYSOP>
  197.    3   27/0002:  VANDERMEULEN-SMITH, PETE, K6ABC, 555-0911, <W0XXX>
  198.  
  199.   So the last name in record number 3, above, does not fit inside a width of
  200.   10 characters, so the whole value is displayed, and the rest of record 3
  201.   is not well aligned.   Still, records 1, and 2, and other records might
  202.   be displayed more neatly.
  203.  
  204.   This WIDTHS command does call for a little bit higher data traffic, so
  205.   if this is not desired, reset the WIDTHS command to behave as before by
  206.   specifying a width of "*":     Use the command: "WIDTHS=*,*,*,*".
  207.   You cannot set the widths to a value greater than 20.
  208.  
  209. V. Version 1.2 Differences
  210.  
  211. Everything you may already know about ARES/Data Version 1.0 and 1.1 still holds
  212. true for Version 1.2.  Version 1.2 fixes a database bug that occurs for
  213. databases over 1000 records, fixes several smaller bugs that could produce
  214. run-time errors, and adds a DIR command which allows a user to list the files
  215. available for download from the public directory.
  216.  
  217. Some users who have very large databases (namely the hams working with the Los
  218. Angeles Marathon) expressed an interest in increasing the speed of the IMPORT
  219. command.  Version 1.2 has significantly improved IMPORT speeds due in part to
  220. the fact that the IMPORT command no longer copies each imported record to the
  221. JOURNAL file (ARESDATA.JRN), but instead places a notation like this:
  222.  
  223. ;Imported file: UPDATE5.IMP at 1900 on 27
  224.  
  225. Another way to speed up IMPORT at the expense of indexing is to reduce the
  226. number of index files.  Versions of the program that index fields 1-3, 1-2, and
  227. only 1 are included on the distribution diskette.  Do not mix usage of these
  228. versions of the program with databases and indices created with ARESDA12.EXE.
  229.  
  230. Also, regular BACKUPS may be disabled by setting the backup interval to 0
  231. in the ARESDATA.CFG file.
  232.  
  233. VI. Version 1.3 Differences
  234.  
  235. Everything you may already know about ARES/Data Versions 1.0-1.2 still holds
  236. true for Version 1.3.  Version 1.3 fixes a nasty bug that caused the database
  237. to start sending the same packet out again and again in an indefinite loop.
  238. This bug only appeared quasi-randomly when long records and messages were
  239. in use.  Thanks to John Leakley, WB9SMM, for bringing this one to our
  240. attention.
  241.  
  242. One new command has been added to the configuraton file ARESDATA.CFG:  logall,
  243. which causes every packet received from the remote stations to be echoed to
  244. the sysop screen.  New sysop commands "logallon" and "logalloff" turn this
  245. feature on and off during program execution.  Another new sysop command is
  246. "rawimport filename", which allows importing of database data in the standard
  247. input format:  Field1, Field2, Field3, Field4, Msg.
  248.  
  249. Various small changes were made in the documentation to make things clearer,
  250. as a result of feedback from interested hams.  One important item:  be sure
  251. the remotely connected stations set PACLEN to a value larger than the maximum
  252. input line length you expect to use.  This is because ARES/Data processes each
  253. incoming packet as a COMPLETE transaction.  If PACLEN is set too small for a
  254. remote station, his/her TNC may send several packets for one input line, which
  255. results in gibberish to the program.
  256.  
  257. VII. Version 1.4 Differences
  258.  
  259. Several users pointed out that with GET of long files or "l all"
  260. situations, the resulting TNC BUSY error would cause part of the
  261. downloaded data to be lost.  To remedy this, the program detects TNC
  262. BUSY conditions and halts polling until the condition clears.  This
  263. means that no data will be lost and sending of the long file will
  264. continue.  To other users, the system will appear to be busy for awhile
  265. until this condition clears.  Read the comments in SYSOP.DOC.
  266.  
  267. We also fragmented the user manual into a set of .HLP files for download
  268. from the public subdirectory.  This effectively makes more of the
  269. ARES/Data documentation available online.  Other small bugs were fixed,
  270. for example, in the results of the "dir" command.
  271.  
  272. VIII. Version 1.5 Differences
  273.  
  274. Version 1.5 allows the ARES/Data program to run "on top of" the G8BPQ
  275. switch, version 4.01.  PK-232, PK-87/88, and other non-DED TNC users,
  276. please note!  This means that ANY KISS TNC can be used at the main
  277. database station, AND that a full NET/ROM-style G8BPQ switch is provided
  278. automatically.  Read G8BPQ.DOC for details on how to set up your BPQ
  279. switch so that ARES/Data becomes a new "application" that is made
  280. available when a user connects to the switch.  Thanks to John Wiseman
  281. for making this important modification to his switch code, and to N1BEE
  282. for his help in modifying the software interrupt used by the module
  283. DEDHOST.EXE.  Implementation of the BPQ interface forms most of the
  284. bulk of the changes for Version 1.5.
  285.  
  286. We also removed a bug in the DIR command that caused the last character
  287. of long filenames to not be sent to the connected station, and a bug
  288. in the processing of text sent to the sysop screen when you use ARES/Data
  289. to connect out to another BBS system.
  290.  
  291.  
  292. We hope you find ARES/Data to be helpful!   And we welcome your
  293. comments.  However, as you might guess, since we are volunteers, we make
  294. no guarantees that we can accommodate all requests.
  295.  
  296. 73, Dave Palmer / N6KL @ K3MC
  297.     Weo Moerner / WN6I @ K3MC
  298.  
  299. August 4, 1989    (Version 1.0)
  300. December 1, 1989  (Version 1.1)
  301. March 3, 1990     (Version 1.2)
  302. October 7, 1990   (Version 1.3)
  303. December 5, 1990  (Version 1.4)
  304. January 20, 1991  (Version 1.5)
  305.